12.1 获取代付汇率(系统实时)
#简要描述: 获取代付汇率接口(系统实时)
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/utils/rate/payment
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
查询参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| key | string | 是 | 商户 key | apiKey |
| currency | string | 是 | 币种(订单币种) | 示例:CNY |
| userCurrency | string | 是 | 用户实收币种 | 示例:USDT |
| sign | string | 是 | md5 签名 | 详情见签名算法(文档2) |
请求json样例
{
"key": "9yUreYgTRtit39Dy",
"currency": "CNY",
"userCurrency": "USDT",
"sign":"dbc72adf640a82e0b21f98c50afb2881"
}
返回值
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| code | int | 请求状态 | 通信状态 成功返回:0,其它表示失败 |
| success | boolean | 成功状态 | true 成功 |
| message | string | 描述 | |
| data | json | 参数 | 参数详见下面说明 |
返回示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"baseCurrency": "USDT",
"quoteCurrency": "CNY",
"tradePair": "USDT/CNY",
"rate": 7.10324538,
"costRate": 0.14078072015020265,
"costReverseRate": 7.10324538,
"exchangeAction": "BUY",
"quoteExpression": "1USDT≈7.1032CNY",
"baseAmount": "14.078072",
"quoteAmount": "100"
}
}
data参数说明
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| baseCurrency | string | 基础货币 | |
| quoteCurrency | string | 报价货币 | |
| tradePair | string | 交易对 | |
| rate | string | 价格 | |
| costRate | number | 计算价格( FROM x rate = TO ) | |
| costReverseRate | number | 反相计算价格( TO x rate = FROM ) | |
| exchangeAction | enum | 交易类型 | BUY:买入| SELL: 卖出 |
| quoteExpression | string | 汇率表达式 | 以报价记的表达式 |
| baseAmount | string | 基础金额 | 示例基础金额 |
| quoteAmount | string | 报价金额 | 示例报价金额 |